---

QuickTime 4 Reference

| Previous | Chapter Contents | Chapter Top | Next |

Constant description

grabPictCurrentImage

Set this flag to 1 to provide the fastest possible image capture. Although this flag may fail under certain circumstances, the failure is recoverable; it just will not return a picture. You can then call SGGrabPict again without the flag set. This routine does not pause the current preview or grab the next frame. It just causes the currently displayed image to be captured. It's a good idea to call SGPause before calling SGGrabPict with this flag.

The flags parameter to the SGSettingsDialog function is a reserved flag and can only be set to 0. QuickTime 2.1 provided a new flag value you can use to indicate that you want to display only panels that make sense for previewing:

enum {
    seqGrabSettingsPreviewOnly      = 1
};


Constant description

seqGrabSettingsPreviewOnly

Set this flag to indicate that the user will be using the dialog box provided by SGSettingsDialog to configure the sequence grabber for previewing only, not for recording. The SGSettingsDialog automatically excludes any panels that aren't necessary for preview configuring, such as video or audio compression settings. Otherwise, set the flags parameter to 0.